home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 5 / MacMania 5.toast / / Tools&Utilities / Plotfoil 3.2 / plotfoil.1 < prev    next >
Encoding:
Text File  |  1995-06-09  |  9.5 KB  |  248 lines  |  [TEXT/ttxt]
  1. .\" plotfoil.1l 2/17/92
  2. .TH plotfoil 1l "Feb. 1992"
  3. .SH NAME
  4. \fBplotfoil\fP \- generate a PostScript plot of airfoil data.
  5. .br
  6. \fBeditfoil\fP \- modify camber and thickness of airfoil data.
  7. .br
  8. \fBmixfoils\fP \- interpolate between two airfoil sections.
  9. .SH SYNTAX
  10. \fBplotfoil\fP [\fIoptions\fP] [\fIfilename...\fP]
  11. .br
  12. \fBeditfoil\fP [\fIoptions\fP] [\fIfilename\fP]
  13. .br
  14. \fBmixfoils\fP [\fIoptions\fP] \fIsection1\fP \fIsection2\fP
  15. .SH DESCRIPTION
  16. \fBplotfoil\fP plots (in PostScript) airfoil sections
  17. (well, actually any section
  18. that is not smoothly closed). It can also allow for spars, 
  19. sheeting, and prints registration marks that are aligned with the L.E. and T.E.
  20. It uses Bezier splines to interpolate between
  21. data points, with an option to use straight lines instead.
  22. .PP
  23. The other two programs, \fBeditfoil\fP and \fBmixfoils\fP, modify airfoil
  24. data. By default they send the data to standard output, so they can be used
  25. in a pipe to \fBplotfoil\fP to plot the results. (Unix only.)
  26. .SH OVERVIEW
  27. Plotfoil reads airfoil data and generates PostScript code that when printed on
  28. a PostScript printer will deliver a plot of the airfoil section along with
  29. spars (if any). The bounds of
  30. the section are also drawn, with crosses, and these can be used for
  31. registration of the ribs or templates. If the plot is going to be larger than
  32. one page, it will automatically be spread over as many pages as are required.
  33. .PP
  34. PostScript is a printer language for describing printed pages. Printers that
  35. accept PostScript include the Apple LaserWriters, QMS PS- series printers,
  36. DataProducts LZR-2665 and 2660 and the Linotronic 100 and 300 typesetters.
  37. PostScript is a trademark of Adobe Systems Incorporated. The ghostscript
  38. program can convert PostScript to a variety of printer formats if a PS
  39. printer is not available. (Ghostscript can also be used to preview plots on
  40. the display.)
  41. .PP
  42. Bezier splines are used to calculate interpolating curves between the points.
  43. In some case the process may not deliver a smooth curve, and you will
  44. have to use the straight-line plot option (\fB\-s\fP).
  45. .PP
  46. \fBplotfoil\fP can also account
  47. for sheeting. If the wing you are building is to
  48. be sheeted, the ribs or templates need to be inset from the required surface
  49. by the thickness of the sheet. The airfoil
  50. outline is plotted with a dotted line, and the template line is drawn with a
  51. solid line.
  52. .SH OPTIONS
  53. Under MS-DOS, the ``/'' can be used as the option character instead of the
  54. ``\-''.
  55. .IP \fB\-c\fR
  56. Sets the chord of the section to plot. The argument is the chord, in units of
  57. either mm, cm or inches. The units are specified by a
  58. trailing `m', `c', or `i',
  59. with the default of mm being used if unspecified.
  60. .IP \fB\-s\fR
  61. This flag indicates that for \fIx\fP values of greater than 2.5%,
  62. straight lines
  63. should be used to join the points. This results in a PostScript file which is
  64. probably just as good but should print in less time. The limit (2.5%) can be
  65. changed with the \fB-l\fP option.
  66. .IP \fB\-l\fR
  67. This option changes the limit used with the \fB-s\fP option. It takes the
  68. percentage-chord as argument.
  69. .IP \fB\-p\fR
  70. This invokes the interactive mode where plotfoil will prompt you for all the
  71. paramters of the plot. If plotfoil is invoked without an arguments it
  72. automatically enters prompt mode.
  73. .IP \fB\-i\fR
  74. This option draws the section inset by the specified amount, which is what you
  75. would use if the wing you are building is sheeted. The units default to those
  76. used for the chord.
  77. .IP \fB\-sp\fP
  78. This option adds a spar to the plot. It takes two arguments, the offset
  79. (expressed as a percentage of the chord) and the thickness of the spar
  80. (default units:
  81. same as used for the chord). This option can be used multiple times to
  82. draw more than one spar. Also, 0-thickness spars can be used to draw vertical
  83. lines on the plot.
  84. .IP \fB\-th\fR
  85. This option sets the height of the template outline, measured from the chord
  86. line. The default is 0.
  87. .IP \fB\-tl\fR
  88. .IP \fB\-tt\fR
  89. These options set the horizontal extents of the template. The value specified
  90. is the distance of the edge of the template from the {leading, trailing} edge.
  91. The units default to those specified while setting the chord. The default
  92. value is 0.
  93. .IP
  94. If any of \fB\-th\fR, \fB\-tl\fR or \fB\-tt\fR is used, a template will be
  95. drawn.
  96. .IP \fB\-a\fR
  97. Turns the section by this many degrees. This useful for adding washout or
  98. washin. A positive number is a rotation in the counter-clockwise direction;
  99. negative is clockwise.
  100. .IP \fB\-h\fR
  101. Prints some help information.
  102. .IP \fB\-o\fR
  103. Writes the output to the specified file.
  104. .IP \fB\-x\fR
  105. This option moves the drawing on the page to the right. Some printers (or
  106. ghostscript drivers) have different ideas about what constitutes
  107. centered. This option can be used for fine-tuning.
  108. .IP \fB\-y\fR
  109. Same as \fB\-x\fR except that it moves the drawing up.
  110. .SH editfoil
  111. .IP \fB\-c\fR
  112. Modifies the camber to this value (expressed as percent. chord). 0 is valid.
  113. .IP \fB\-t\fR
  114. Modifies the thickness to this value (expressed as percent. chord).
  115. .IP \fB\-o\fR
  116. Writes the output to the specified file.
  117. .SH mixfoils
  118. .IP \fB\-r\fR
  119. The interpolation ratio. The generated section will be \fIr\fP of the second
  120. section and \fI(100-r)\fP of the first. If you have one section at the root
  121. and another at the tip, to find the section at 70% semi-span out you
  122. would use 70.
  123. .IP \fB\-o\fR
  124. Writes the output to the specified file.
  125. .SH INPUT FORMATS
  126. There are two formats for \fBplotfoil\fP input data,
  127. distinguished by how coordinates are
  128. specified. The first line of the file is taken to be the name of the section
  129. and is printed along with the plot.
  130. .PP
  131. The smallest \fIx\fR value (usually 0.0) is the L.E. and the largest
  132. (usually 1.0) is the T.E.
  133. .PP
  134. This is the first format:
  135. \fC
  136.    SD-8020
  137.    1.0 0
  138.    0.9 0.011
  139.    0.85 0.02
  140.    ...
  141.    1.0 0
  142. \fR
  143. .br
  144. Note: it starts at \fIx\fP=1.0 (the trailing edge), goes around 
  145. and ends again at the
  146. T.E. This is the format used by the sections in Soartech 8.
  147. .PP
  148. This is the second format:
  149. \fC
  150.    Clark YH
  151.    0 0 0
  152.    0.0125 0.0409 -0.0183
  153.    0.025 .0529 -.0271
  154.    ...
  155.    1.0 0 0
  156. \fR
  157. .br
  158. This starts at the L.E. and ends at the T.E., with the columns being the upper
  159. and lower ordinate values. This is the format that most of the NACA sections
  160. were published in.
  161. .LP
  162. \fBeditfoil\fP and \fBmixfoils\fP both print data in the first format.
  163. .SH EXAMPLES
  164. This command:
  165. .IP
  166. \fC\s-2plotfoil -c 20c -i 2m -sp 32 0.2 sd8020 | lpr\s+2\fR
  167. .LP
  168. will plot the SD-8020 section with a chord of 20cm, with a sheeting allowance
  169. of 2mm, and a spar 2mm wide at 32% chord. The name of the section and the
  170. sheeting allowance are also printed.
  171. .IP
  172. \fC\s-2plotfoil -c 8.5i -i 0.125 -s -l 10 -o clarkYH.ps clarkYH\s+2\fR
  173. .LP
  174. will plot the Clark YH with a chord of 8.5 inches. Only the area from the L.E.
  175. to 10% back will interpolated with splines, and from 10% to the T.E.; straight
  176. lines will be used to connect the points. A sheeting allowance of 0.125" (1/8")
  177. will also be drawn. The PostScript will be left in "clarkYH.ps".
  178. .IP
  179. \fC\s-2plotfoil -c 450m -i 1 -sp 5 0.5 -sp 30 2.5 -th 70 -tt 10 -tl 10 -x -1.5c -o rg15.ps RG-15\s+2\fR
  180. .LP
  181. This plots the RG-15 airfoil with a chord of 450mm. Since this is too large
  182. to fit on one page it will be automatically split across two pages. A
  183. sheeting allowance of 1mm is printed, and there are two spars: one at 30%
  184. that's 2.5mm thick, and another at 5% that's very narrow, i.e. a LE marking.
  185. A rectangular template
  186. is drawn around the plot; and all the graphics are moved to the \fIleft\fR
  187. by 1.5cm, i.e. negative numbers can be used in the positioning. The
  188. PostScript is saved in "rg15.ps".
  189. .IP
  190. \fC\s-2editfoil -c 0 -o symmetric.airfoil SD-7037 \s+2\fR
  191. .LP
  192. Construct a symmetric airfoil from the SD-7037 and save as "symmetric.airfoil".
  193. .IP
  194. \fC\s-2editfoil -t 7 -c 1.5 RG-15 | plotfoil -c 400m -i 1 -sp 30 1.5 | lpr\s+2\fR
  195. .LP
  196. Plot a thinned down (7%) de-cambered (1.5%) RG-15.
  197. .IP
  198. \fC\s-2mixfoils -r 75 -o mixed-airfoil SD-7037 SD-7032\s+2\fR
  199. .LP
  200. Generate a section that is 25% SD-7037 and 75% SD-7032.
  201. .SH DISTRIBUTION
  202. \fBplotfoil\fP, \fBeditfoil\fP and \fBmixfoils\fP are free;
  203. anyone may redistribute copies of it to anyone
  204. under the terms stated in the Gnu General Public License version 2, a
  205. copy of which should accompany each copy of plotfoil. See the file ``COPYING''
  206. in the source area. If you do not have this file, a copy may be obtained from
  207. the author, or from:
  208.    Free Software Foundation
  209.    1000 Mass Ave.
  210.    Cambridge, MA 02138
  211. .br
  212. or from the author.
  213. .LP
  214. Also, if you make any changes to these programs and re-distribute them,
  215. the same
  216. conditions apply to the modified version so that we can all benefit from
  217. it. And please send me those changes!
  218. .SH AUTHOR
  219. Shamim Mohamed (shamim@math.isu.edu)
  220. .br
  221. Dept of Mathematics
  222. .br
  223. Idaho State University
  224. .br
  225. Pocatello, ID 83209
  226. .SH BUGS
  227. On some printers, there may be a stack overflow if the plot is on more than one
  228. page and there are more than a certain number of coordinate values. If this
  229. happens, try
  230. .IP
  231. a) finding another printer, or
  232. .IP
  233. b) removing some of the airfoil data.
  234. .LP
  235. In the latter case you may still get satisfactory results because of the
  236. smooth interpolation used.
  237. .PP
  238. Since the program doesn't know how big the printer page size is, it can get
  239. confused. This should only err conservatively, like producing an extra blank
  240. page on a multi-page plot. As long as the page is higher than about 11 inches
  241. (27 cm) everything should be fine. If you have a compiler, adjust the values
  242. in \fC\s-1plotfoil.h\s+1\fP and recompile.
  243. .PP
  244. I don't know of any other bugs right now,
  245. but please send all bug reports to me. Include
  246. version number and the exact details (input files, command-line options  etc.),
  247. please.
  248.